home *** CD-ROM | disk | FTP | other *** search
/ Aminet 40 / Aminet 40 (2000)(Schatztruhe)[!][Dec 2000].iso / Aminet / dev / misc / guigfxlib.readme < prev    next >
Encoding:
Text File  |  2000-11-02  |  6.9 KB  |  194 lines
  1. Short:    Application layer for pixel graphics
  2. Author:   Timm S. Müller
  3. Uploader: Timm S. Müller (bifat@neoscientists.org)
  4. Version:  17.1
  5. Type:     dev/misc
  6. Requires: Kickstart 3.0 (v39), MC68020, render.library v30
  7.  
  8.  
  9. overview
  10. -----------------------------
  11.  
  12.   - guigfx.library is an application layer for pixel graphics.
  13.  
  14.   - guigfx.library breaks the chains of all those nasty
  15.     planar, chunky, 8/16/24bit, OS3.0, OS3.1, OCS, ECS, AGA,
  16.     CybergraphX and Picasso96 considerations.
  17.  
  18.   - with guigfx.library you no longer have to take care about your
  19.     application running on a OCS machine or on a high-end
  20.     graphics-card system.
  21.  
  22.   - guigfx.library lets you freely choose truecolor graphics for
  23.     your applications.
  24.  
  25.   - with guigfx.library your graphics will always look as fine as
  26.     possible, on any screen, no matter if driven on 24 bit
  27.     1024x768 CybergraphX/Picasso96, on HAM8, or 1 bit productivity
  28.     interlaced.
  29.  
  30.   - guigfx.library does quick color-reduction, rendering,
  31.     remapping and dithering for you. only you don't know when,
  32.     on which machine, under what circumstances.
  33.  
  34.   - guigfx.library treats scaling as a standard operation.
  35.     it is available at any time, without extra consideration,
  36.     without extra memory consumption, even without a true loss
  37.     of performance.
  38.     
  39.   - guigfx.library handles screen pen allocation in an extremely
  40.     effective way.
  41.  
  42.   - guigfx.library hides bugs, incompatibilities and insufficiencies
  43.     of graphics.library, cybergraphics.library and Picasso96 from
  44.     you. it is an attempt to render incompatibilities between
  45.     different versions of CybergraphX and Picasso96 obsolete.
  46.     
  47.   - guigfx.library features picture.datatype import. standard and
  48.     v43 (including Picasso96) picture datatypes are automatically
  49.     recognized and used as available.
  50.  
  51.   - guigfx.library does not call SetFunction() and is hereby
  52.     guaranteed to never do so in future versions.
  53.  
  54.   - guigfx.library puts all that stuff into a black-box,
  55.     freeing your mind for the creative part.
  56.  
  57.  
  58.  
  59. features
  60. -----------------------------
  61.  
  62.   - full truecolor, OCS, ECS, AGA, HAM support
  63.   - screen-pen management
  64.   - color-reduction
  65.   - dithering
  66.   - picture.class datatype import
  67.   - scaling
  68.   - image processing methods 
  69.     (crop, scale, render, tint, 
  70.     alpha-channel, texture-mapping, ...)
  71.   - fully documented
  72.   - supplied with C includes for SAS/C, StormC and MaxonC
  73.   - freeware
  74.  
  75.  
  76.  
  77. requirements
  78. -----------------------------
  79.  
  80.   - render.library v30 (dev/misc/renderlib.lha)
  81.   - MC68020
  82.   - OS3.0 (v39)
  83.   
  84.   optional:
  85.   higher OS, higher CPU, FPU,
  86.   CyberGraphX or Picasso 96
  87.  
  88.  
  89.  
  90. contact
  91. -----------------------------
  92.  
  93.   bifat@neoscientists.org
  94.   http://www.neoscientists.org
  95.  
  96.  
  97.  
  98. recent changes
  99. -----------------------------
  100.  
  101. v17.1
  102.     - added an internal hook delay counter. user hooks
  103.       are now called less frequently during scaling/rendering,
  104.       which gives a slight performance boost in some
  105.       applications
  106.     
  107.     - guigfx.library no longer loses memory upon open/close.
  108.       this leak was present for eons. fixing it caused the library
  109.       itself to shrink by several kilobytes of useless object
  110.       code. no, i won't tell more details about this #*&%! one :-)
  111.  
  112.     - removed the examples from the distribution because they were
  113.       everything but instructive.
  114.  
  115. v17
  116.     - bug fixed: the drawhandle's autodither attribute
  117.       was not considered in CreatePictureBitMap().
  118.     
  119.     - added GGFX_AutoDither tag for CreatePictureBitMap()
  120.       for overriding the drawhandle's autodither tag.
  121.  
  122. v16.4
  123.  
  124.     - reconstructed 16.3 changes after a minor HD desaster
  125.  
  126. v16.3
  127.  
  128.     - bug fixed in LoadPicture(): GGFX_UseMask was broken.
  129.       memory for an alphachannel/mask was always allocated
  130.       when there was a transparency color inside the picture,
  131.       regardless of the GGFX_UseMask attribute. now an
  132.       alphachannel is only allocated when both GGFX_UseMask
  133.       is set and a mask is actually present.
  134.       
  135.     - added documentation for a feature that was present
  136.       and considered experimental since v8.3: drawing with
  137.       rotating/texture-mapping in a single pass, without
  138.       additional buffers. see: ObtainDrawHandle()/GGFX_BGColor
  139.       and DrawPicture()/RND_DestCoordinates.
  140.  
  141.  
  142. ============================= Archive contents =============================
  143.  
  144. Original  Packed Ratio    Date     Time    Name
  145. -------- ------- ----- --------- --------  -------------
  146.      441     186 57.8% 04-Jun-99 03:15:46 +doc.info
  147.      324     175 45.9% 04-Jun-99 03:15:46 +author.info
  148.      441     182 58.7% 04-Jun-99 03:15:46 +autodoc.info
  149.    93718   17401 81.4% 25-Jan-00 20:11:50 +guigfx
  150.      324     175 45.9% 04-Jun-99 03:15:46 +examples.info
  151.      324     173 46.6% 04-Jun-99 03:15:46 +history.info
  152.     2181     865 60.3% 01-Oct-99 12:10:44 +legal
  153.      324     177 45.3% 04-Jun-99 03:15:46 +legal.info
  154.     1712     763 55.4% 21-Jul-98 08:01:08 +prefs
  155.      324     177 45.3% 04-Jun-99 03:15:46 +prefs.info
  156.      450     200 55.5% 24-May-99 02:17:02 +fd.info
  157.      450     200 55.5% 24-May-99 02:17:02 +include.info
  158.      450     198 56.0% 24-May-99 02:17:02 +libs.info
  159.      441     186 57.8% 24-May-99 02:17:02 +maxonc.info
  160.      441     188 57.3% 24-May-99 02:17:02 +Prefs.info
  161.      324     173 46.6% 24-May-99 02:17:02 +readme.info
  162.      530     293 44.7% 19-Jan-00 10:56:26 +author
  163.    79751   15822 80.1% 23-Jan-00 18:10:06 +guigfx.doc
  164.      324     177 45.3% 04-Jun-99 03:15:32 +guigfx.doc.info
  165.      324     218 32.7% 01-Oct-99 12:20:16 +guigfx.info
  166.     3893    1264 67.5% 14-Feb-99 00:21:40 +examples
  167.    19394    7412 61.7% 31-Jan-00 19:14:40 +history
  168.     1245     483 61.2% 01-Jan-98 00:30:46 +guigfx_lib.fd
  169.     3166     765 75.8% 23-May-99 21:36:26 +guigfx_protos.h
  170.     3241    1034 68.0% 31-Jan-00 19:16:24 +guigfx.h
  171.     2427     543 77.6% 26-Jul-98 18:25:42 +guigfx_pragmas.h
  172.      180     128 28.8% 06-Jan-98 09:17:00 +guigfx.h
  173.    43976   23676 46.1% 31-Jan-00 19:10:58 +guigfx.library
  174.     4190    1898 54.7% 31-Jan-00 19:14:44 +readme
  175.    41604   22274 46.4% 31-Jan-00 19:15:18 +guigfx.library_68040
  176.    41620   22327 46.3% 31-Jan-00 19:17:38 +guigfx.library_68060
  177.    41580   22289 46.3% 31-Jan-00 19:13:04 +guigfx.library_FPU
  178.      441     180 59.1% 06-Jan-98 09:17:00 +c-libs.info
  179.     5254     853 83.7% 19-May-99 22:45:00 +guigfx.lib
  180.      888     457 48.5% 24-May-99 01:59:36 +maxon.readme
  181.      324     182 43.8% 06-Jan-98 09:17:00 +maxon.readme.info
  182.      441     183 58.5% 06-Jan-98 09:17:00 +pragma.info
  183.     1792     466 73.9% 19-May-99 22:45:00 +guigfx_lib.h
  184.        3       3  0.0% 06-Jan-98 09:17:00 +AUTODITHERTHRESHOLD
  185.      441     184 58.2% 31-Jan-00 19:05:22  GuiGFXLib.info
  186.        1       1  0.0% 29-Jun-98 05:52:12 +USESCALEPIXELARRAY
  187.        1       1  0.0% 06-Jan-98 09:17:00 +USEWPA8
  188.      441     178 59.6% 24-May-99 02:17:08 +stormc.info
  189.     2938     580 80.2% 19-May-99 22:49:44 +guigfx_lib.h
  190.     2303     868 62.3% 19-May-99 22:46:52 +disk_pragmas.h.info
  191.      134     126  5.9% 19-May-99 23:20:04 +guigfx_pragmas.h
  192. -------- ------- ----- --------- --------
  193.   405516  146284 63.9% 01-Feb-100 19:27:42   46 files
  194.